home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / pimslist / vend30gb.zip / VENDOR.DOC < prev    next >
Text File  |  1995-03-14  |  40KB  |  831 lines

  1.     PROGRAM TITLE:
  2.  
  3.     The Disk Vendor
  4.  
  5.  
  6.     DESCRIPTION:
  7.  
  8.     The Disk  Vendor is  a tool  for creating  "on-disk" product
  9.     catalogs.  For businesses  who would like an  alternative to
  10.     a printed catalog, The Disk Vendor will make the process  of
  11.     creating an on-disk catalog a simple one.
  12.  
  13.     The Disk Vendor run-time  module is completely menu  driven,
  14.     with a clean simple user interface, which makes it easy  for
  15.     your customers to navigate through and order from.
  16.  
  17.     The product catalogs that  you create can be  distributed on
  18.     a diskette, or printed to hardcopy format.
  19.  
  20.  
  21.     AUTHOR:
  22.  
  23.     Philip P. Kapusta
  24.     P.O. Box 5423
  25.     Falmouth, VA 22403-5423
  26.     BBS 703 372-9680 (SYSOP)
  27.  
  28.  
  29.     REQUIREMENTS:
  30.  
  31.     Hard disk drive, printer, and an editor/word processor.
  32.  
  33.  
  34.     TERMS AND DEFINITIONS:
  35.  
  36.     There are several  terms that will  be used throughout  this
  37.     documentation and that  need to be  fully understood by  the
  38.     user before  you create  your own  on-disk catalog.   Please
  39.     review these definitions carefully:
  40.  
  41.     ASCII FILE: This  is a term  used to describe  any file that
  42.     you create  and save  with an  editor such  as DOS'  EDIT or
  43.     Window's  Notepad.   The Disk Vendor  does NOT come  with an
  44.     editor because most users already have a favorite editor  or
  45.     word processor that they feel  comfortable with.  We saw  no
  46.     reason to  force the  user to  use another  editor and  have
  47.     consequently not included  one.  An ASCII file contains only
  48.     characters that can be found on a standard IBM keyboard.
  49.  
  50.     CATALOG  FILE:  A  catalog  file  is  an  ASCII  file   that
  51.     contains product  numbers, product  names and  descriptions.
  52.     These files are identified by the file extension ".CAT"  and
  53.     can  be  edited  or  created  with  a program like DOS' EDIT
  54.     editor,  or  Window's  Notepad,  or any programmer's editor.
  55.     You can even  use your favorite  word processor to  edit and
  56.  
  57.     generate catalog files, but  you must remember to  save them
  58.     as  ASCII  files.    You  use   The  Disk  Vendor   compiler
  59.     (COMPILE.EXE)  to  merge  and  compress  all your individual
  60.     .CAT catalog files into one single data file (CATALOG.DAT).
  61.  
  62.     COMPILER: The compiler  is the program  that gathers all  of
  63.     your   ASCII   catalog   files   (*.CAT)   and   all   other
  64.     miscellaneous ASCII text files (*.TXT), and then merges  and
  65.     compresses  this  information  into   a  single  data   file
  66.     (CATALOG.DAT).   The Disk  Vendor compiler  also prompts the
  67.     user for information such  as quantity discount rates,  your
  68.     mailing  address,  sales  tax,  and  currency  format before
  69.     actual compilation begins.
  70.  
  71.     DATA  FILE:  The  data  file  is  a  specially formatted and
  72.     compressed  file  that  contains  ALL  your  product  names,
  73.     prices,  mailing  address,   shipping  costs,  opening   and
  74.     closing screens, etc.   This data file  is created by  using
  75.     The Disk Vendor compiler (COMPILE.EXE) and once it has  been
  76.     created it can be identified by the filename  "CATALOG.DAT".
  77.     This data file is one  of the two necessary files  that must
  78.     be placed on your distribution disk for your customers.
  79.  
  80.     HELLO AND GOODBYE FILES:  These are silly sounding  terms, I
  81.     admit, but their  names imply what  you would think.   These
  82.     are two OPTIONAL files  that are displayed at  the beginning
  83.     and end of  your on-disk catalog.   The opening screen  file
  84.     is identified with the filename "HELLO.TXT" and the  closing
  85.     screen  as  "GOODBYE.TXT".   You  can  have  a  hello   file
  86.     without  a  goodbye  file,  or  vice  versa.   One  does not
  87.     require the other.  Or you may wish to eliminate both.   The
  88.     choice is up to you.  These files are extended ASCII  files,
  89.     which means  you can  use any  of the  high ASCII characters
  90.     (graphics) such as ║ ▒ █  ╚ ½ å.  (Note: Some  printers will
  91.     not display  these characters  properly if  you are printing
  92.     the VENDOR.DOC file).
  93.  
  94.     RUN-TIME  MODULE:  Refers  to  the file "CATALOG.EXE".  This
  95.     is  the  program  that  reads  the  information in your data
  96.     file and displays it to your customers.  Remember, in  order
  97.     to create a catalog on a disk for your customers, two  files
  98.     must exist on that disk:  1) CATALOG.EXE and 2) CATALOG.DAT.
  99.  
  100.     SHIPPING  FILE:  This  is  a  small ASCII file that contains
  101.     information  on  the  various  modes  of  shipping and costs
  102.     available  to  your  customer.   It  is  identified  by  the
  103.     filename "SHIPPING.TXT".
  104.  
  105.     TEXT  FILE:   Text  files  are  ASCII  files  that   contain
  106.     miscellaneous  messages  and  notes   that  you  want   your
  107.     customers to have access to.   Text files are identified  by
  108.     the  file  extension  ".TXT"  and  must NOT be confused with
  109.  
  110.     catalog  files.   Text  files  should  NOT  contain products
  111.     that you  want your  customers to  order, unless  you expect
  112.     them to  hand write  those items  at the  end of their order
  113.     form.  The contents of text files can only be viewed on  the
  114.     screen, and  no order  prompts, prices  or discount  windows
  115.     appear in conjunction with  "*.TXT" text files.   An example
  116.     of a useful  text file would  be a file  that gives a  brief
  117.     sketch about  your company  or about  how your  products are
  118.     better than your competitor's.
  119.  
  120.     WAIT FILE: This  is a special  ASCII file that  is displayed
  121.     to your  customers by  the run  time module  as it  reads in
  122.     information from the data file.   It can be considered as  a
  123.     commercial message if you wish.  It is called a "wait  file"
  124.     because its  contents are  displayed on  the screen  as your
  125.     customer waits  for the  program to  finish a  task.   It is
  126.     appropriately identified by the filename "WAIT.TXT".
  127.  
  128.     With these terms  now under your  belt you will  be ready to
  129.     begin creating your own on-disk shareware catalog.
  130.  
  131.  
  132.     LET'S GET STARTED:
  133.  
  134.     The  first  thing  that  we  recommend  a  brand new user to
  135.     do  is  to  run  the  compiler  (COMPILE.EXE) and generate a
  136.     personalized  data  file  (CATALOG.DAT).   Then  after  this
  137.     execute  the  run  time  module  (CATALOG.EXE)  so  that you
  138.     can see  how quick  and easy  it is  to generate  a catalog.
  139.     Do this right  now!  At  the DOS prompt,  just enter COMPILE
  140.     and fill in the blanks  as you are prompted by  the program.
  141.     Once you  have done  this, enter  CATALOG at  the DOS prompt
  142.     and look at your results.
  143.  
  144.     Before you  generate your  own catalog  files (*.CAT)  spend
  145.     some  time  getting  familiar  with  the  run-time    module
  146.     (CATALOG.EXE).   Explore its  features and  interface.   Try
  147.     placing a few orders as if  you were a customer.  Print  out
  148.     your order forms, print the catalog, search for words,  save
  149.     and retrieve  your orders,  etc.   By playing  with the run-
  150.     time module you will  get a feel for  the power and ease  of
  151.     use that The Disk Vendor provides you.
  152.  
  153.     Once  you  have  spent  some  time  with the run-time module
  154.     (CATALOG.EXE)  and  the  compiler  (COMPILE.EXE)  then   you
  155.     should begin creating your very own catalog files (*.CAT).
  156.  
  157.     To begin, use  your favorite text  editor or word  processor
  158.     and open a new file.  We will call the name of the new  file
  159.     "VIRUS.CAT"  and  we  will  generate  a  catalog  file  that
  160.     contains virus  checking software  programs.   Note: You can
  161.     give the file any name you wish as long as it  contains  the
  162.  
  163.     file  extension  ".CAT".   "SOFTWARE.CAT",   "DISNFECT.CAT",
  164.     "_VIRUS_.CAT" are  all valid  catalog file  names.  Whatever
  165.     is  easiest  for  you  to  remember,  give it an appropriate
  166.     filename.
  167.  
  168.     THE STRUCTURE OF A CATALOG FILE:
  169.  
  170.     Once you  begin a  new catalog  file, there  is a   specific
  171.     format that you must follow:
  172.  
  173.     1) The  very first  line of  the catalog  file (*.CAT)  must
  174.     contain  a  34  character  or  less  description.  The first
  175.     line  of  a  catalog  file  will  be  used  in the Main Menu
  176.     catalog index listing.
  177.  
  178.     2) A pound symbol "#" separates one product and  description
  179.     from  another.   The  "#"  can  be  followed by your catalog
  180.     number identifying  the product  that follows  it.   Catalog
  181.     order numbers must not be longer than 20 characters.
  182.  
  183.     3) The name of the product  follows on  the next line  after
  184.     the line that contains the "#" symbol.
  185.  
  186.     4) Any  lines after  the product  name are  used for  you to
  187.     describe that product.
  188.  
  189.     5)  Product  description  line  length  must  not  exceed 72
  190.     characters in width.  This is one rule that is often  easily
  191.     forgotten.   It  may  seem  minor,  but  for  the program to
  192.     generate  a  printed  catalog  for  your  customers  with  a
  193.     sufficient  left  margin  for  punching  holes  for a 3-ring
  194.     binder,  product  description  lines  can  not  exceed   nor
  195.     encroach upon the  margins.  Most  "good" text editors  will
  196.     have the option to define  a right margin width, and  with a
  197.     word-wrap feature,  this 72  character line  limit will  not
  198.     pose  a  problem.   Most  word  processors that export ASCII
  199.     text also will word wrap, along with being able to define  a
  200.     right margin.   The compiler will  catch any violations  and
  201.     will  stop,  bringing  to  your  attention  any  line length
  202.     violations.    I  have   a  favorite   text  editor   called
  203.     Multi-Edit,   published   by   American   Cybernetics.   For
  204.     approximately $80  it is  loaded with  everything you  could
  205.     want in a  text editor.   I highly recommend  it if you  can
  206.     afford it  and are  looking for  a text  editor besides  the
  207.     freebie Microsoft ships with DOS versions 5.0 and up.
  208.  
  209.     All right, got it?  Clear as  mud?  Probably.  So here   are
  210.     some examples  that will  help you.   Again, we  are in  our
  211.     editor and have the file "VIRUS.CAT" open.  With the  cursor
  212.     at  the  very  top  of  the  document  (line  1),  enter   a
  213.     description used  to identify  the contents  of the  catalog
  214.     file:
  215.  
  216.     ┌─────────────────────────────────────────────────────────┐
  217.     │Virus protection software                                │
  218.     │                                                         │
  219.     │                                                         │
  220.     │                                                         │
  221.  
  222.     It is  simple so  far, isn't  it?   Just keep  the number of
  223.     characters in this description line less than 34.
  224.  
  225.     Now, on to line 2!
  226.  
  227.     As we stated above, a "#" symbol separates one product  from
  228.     another.   Since we  are about  to enter  a new product name
  229.     and description, we need to place a "#" on line 2, column 1:
  230.  
  231.     ┌─────────────────────────────────────────────────────────┐
  232.     │Virus protection software                                │
  233.     │#                                                        │
  234.     │                                                         │
  235.     │                                                         │
  236.  
  237.     If  you  wish  to  identify  your  products  using a catalog
  238.     number, now  is the  time to  do so.   Immediately following
  239.     the "#" symbol, enter your catalog number.  The number  does
  240.     not need to  be a number,  but can be  characters if you  so
  241.     choose, or a combination of both.  For example:
  242.  
  243.     ┌─────────────────────────────────────────────────────────┐
  244.     │Virus protection software                                │
  245.     │#VI040                                                   │
  246.     │                                                         │
  247.     │                                                         │
  248.  
  249.     Again, you  are not  required to  enter a  catalog number if
  250.     you choose not  to.  What  is mandatory, however,  is that a
  251.     "#" symbol exists in column 1 and must precede the line that
  252.     contains the product name.
  253.  
  254.     When you are  ready to enter  a product name,  move down one
  255.     line below the "#" and enter it:
  256.  
  257.     ┌─────────────────────────────────────────────────────────┐
  258.     │Virus protection software                                │
  259.     │#VI040                                                   │
  260.     │Expel                                                    │
  261.     │                                                         │
  262.  
  263.     In the example above  the software program "Expel"  has been
  264.     placed immediately below the line containing the "#" symbol.
  265.  
  266.     To show you some of  the features unique to The  Disk Vendor
  267.     we will let you  know here that you  can add a comment  note
  268.     on the same line  as the product name.  A "comment note" may
  269.  
  270.     consist of anything you wish,  as long as it is  enclosed in
  271.     squiggly brackets  {}.   For example,  let's say  that Expel
  272.     is  obtained   wholesale  through   your  distributor   Acme
  273.     Software.  Your sales  representative with Acme Software  is
  274.     Jim Smith.  If you wanted  to make a note of that  fact, you
  275.     can add a comment note recording this.  For example:
  276.  
  277.     ┌─────────────────────────────────────────────────────────┐
  278.     │Virus protection software                                │
  279.     │#VI040                                                   │
  280.     │Expel {Acme: Jim Smith}                                  │
  281.     │                                                         │
  282.  
  283.     Above  we  see  that  the  software title Expel is purchased
  284.     through  Acme  Software,  whose  sales  rep.  is  Jim Smith.
  285.     This comment note is enclosed in {} brackets.  The  brackets
  286.     are very  important!   When this  catalog file  is compiled,
  287.     your  comment  notes  are  ignored.   Comment  notes  in  {}
  288.     brackets do not appear  to your customer because  they never
  289.     find their way  into the data  file (CATALOG.DAT).   Comment
  290.     notes are  for your  use and  are optional.   You can  enter
  291.     anything  you  wish  between  {}  brackets  -  the name of a
  292.     company, a stock bin number, an inventory count, the  weight
  293.     of  the  product,  whatever.   Again,  this  comment note is
  294.     optional.
  295.  
  296.     The next  bit of  information that  you need  to add  is the
  297.     selling  price  for  the  product.   At  the end of the line
  298.     that contains the product  name, enter its price.   Although
  299.     you can add a currency symbol before the price, this is  not
  300.     necessary, and in  fact it is  not recommended.   The reason
  301.     we do not recommend that  you enter a currency symbol  (e.g.
  302.     "$")  is  because  it  takes  up  file  space.  The run-time
  303.     module does not need  the currency symbol repeated  hundreds
  304.     of times in your *.CAT files.   One little "$" sign may  not
  305.     seem like much,  but if you  repeat this symbol  hundreds of
  306.     times  it  slowly  eats  up  disk  space.   But if you can't
  307.     break  the  habit,  that's  fine  too.   The  compiler   and
  308.     run-time module do not care.
  309.  
  310.     ┌─────────────────────────────────────────────────────────┐
  311.     │Virus protection software                                │
  312.     │#VI040                                                   │
  313.     │Expel {Acme: Jim Smith} 23.95                            │
  314.     │                                                         │
  315.  
  316.     Above we  see a  price of  $23.95 for  one unit  of "Expel".
  317.     This  $23.95  is  the  undiscounted  selling  price for this
  318.     product to  your customers.   If you  wish to  give multiple
  319.     quantity discounts, see  the compiler (COMPILE.EXE)  and set
  320.     up  the  discount  rates  at  compile  time.   Here  in your
  321.     catalog file (*.CAT) simply  enter the price of  the product
  322.     item as shown above.
  323.  
  324.     Now that we  have entered a  product number, a  product name
  325.     and  price,  all  that  we  have  left  is  to  give Expel a
  326.     description.    The   product   description   lines   follow
  327.     immediately  below  the  line  that  contains  the product's
  328.     name and price.  For example, let's describe Expel:
  329.  
  330.     ┌─────────────────────────────────────────────────────────┐
  331.     │Virus protection software                                │
  332.     │#VI040                                                   │
  333.     │Expel {Acme: Jim Smith} 23.95                            │
  334.     │Anti-virus program that helps preserve the integrity of  │
  335.     │your files.                                              │
  336.     │                                                         │
  337.  
  338.     You can definitely get more descriptive if you wish.  We  do
  339.     not  recommend  that  you  enter  more  than  13 lines for a
  340.     program description because it will be truncated when it  is
  341.     compiled.  13 lines should  be more than enough to  describe
  342.     most programs.  Also,  keep all description lines  less than
  343.     72  characters  wide.   You  can  insert  blank lines if you
  344.     wish, and they will be preserved when compiled.
  345.  
  346.     Believe it or  not, that is  all there is  to it!   Not very
  347.     hard is it?
  348.  
  349.     To add additional programs to our "VIRUS.CAT" catalog  file,
  350.     simply repeat  steps 2-4  above.   Here is  our catalog file
  351.     after adding two more virus checking programs:
  352.  
  353.     ┌─────────────────────────────────────────────────────────┐
  354.     │Virus protection software                                │
  355.     │#VI040                                                   │
  356.     │Expel {Acme: Jim Smith} 23.95                            │
  357.     │Anti-virus program that helps preserve the integrity of  │
  358.     │your files.                                              │
  359.         │#VI107                                                   │                                             │
  360.     │Flu Shot+ 17.95                                          │
  361.     │Protects you system against virus and Trojan horse       │
  362.     │programs. Read/write protection for programs. Checks for │
  363.     │contamination and prevents virus activities.             │
  364.     │#VI100                                                   │
  365.     │Virex {Version 2.1} 34.95                                │
  366.     │Virex checks an entire disk for over 800 different virus │
  367.     │strains.  If it detects a virus, Virex will remove the   │
  368.     │virus from the program or disk.  Quarterly update        │
  369.     │virus signature lists are available from the publisher   │
  370.     │to protect your computer against new virus strains.      │
  371.  
  372.     Notice  that  you   do  NOT  repeat   the  "Virus protection
  373.     software" category  description line.    This  occurs   only
  374.     ONCE, and must  be on the   first  line   of  your   catalog
  375.     file (VIRUS.CAT).
  376.  
  377.     We  strongly  recommend  that  you enter/insert new products
  378.     in alphabetical order.   This will make your  catalog easier
  379.     to navigate through  when viewed by  your customers.   There
  380.     exists  a  function  in  The  Disk  Vendor  run-time  module
  381.     (CATALOG.EXE)  that  lists  all  the  product  items  in the
  382.     currently selected  category.   This "quick  browse" listing
  383.     displays the products' names in the same order in which  you
  384.     entered them into the catalog file.  Therefore, if you  want
  385.     this list to appear in alphabetical order, you should  enter
  386.     the products in  alphabetical order.   The Disk Vendor  will
  387.     not sort  this list  because it  wants you  to practice good
  388.     catalog file creation and maintenance.   It is also to  your
  389.     benefit  to  enter  and  maintain  products  in alphabetical
  390.     order.  It  not only makes  it easier for  your customers to
  391.     locate products, but  it makes it  easier for YOU  to locate
  392.     products when it comes time to update or purge your  catalog
  393.     files.
  394.  
  395.     If these  3 titles  are all  you have  in the  way of  virus
  396.     checking  software programs, then  close  the    "VIRUS.CAT"
  397.     catalog file and save it to disk.
  398.  
  399.     One last  feature that  you may  be interested  in adding to
  400.     your catalog file is a  "customer note".  A "customer  note"
  401.     contains  text  information  that  helps better describe the
  402.     items that follow.  A  "customer note" does NOT have  prices
  403.     or part  numbers attached  to them.   You begin  a  customer
  404.     note with  a "#"  symbol, immediately  followed by  "NOTE#".
  405.     Move down one line and  enter a header line, then  move down
  406.     one line and enter the  ASCII text that makes up  your note.
  407.     Using the VIRUS.CAT file as an example:
  408.  
  409.     ┌─────────────────────────────────────────────────────────┐
  410.     │Virus protection software                                │
  411.     │#VI040                                                   │
  412.     │Expel {Acme: Jim Smith} 23.95                            │
  413.     │Anti-virus program that helps preserve the integrity of  │
  414.     │your files.                                              │
  415.     │#NOTE#                                                   │
  416.     │WHAT IS A COMPUTER VIRUS?                                │
  417.     │A computer virus is a program designed to replicate and  │
  418.     │spread on its own, preferable without you knowing it     │
  419.     │exists.  Like a human body, computers are vulnerable to  │
  420.  
  421.     It is best to experience a customer note in a compiled  data
  422.     file first hand in order  to appreciate its usefulness.   We
  423.     have included several customer  notes in the sample  catalog
  424.     files (*.CAT) that accompanied  this program.   Take a  good
  425.     look at these files to understand how they work.
  426.  
  427.     Customer notes  can occur  anywhere in  your catalog  files,
  428.     and they can  be unlimited in  length (1 to  1000 lines) but
  429.     are restricted to 72 columns in width.
  430.  
  431.     A few  other guidelines  that you  should be  aware of  when
  432.     working with catalog files (*.CAT):
  433.  
  434.         Use lower  case letters  as much  as possible. Upper
  435.         case  letters  do  not  compress well during compile
  436.         time.  On average you  will achieve a 40% file  size
  437.         reduction if the majority of your catalog files  are
  438.         in lower  case (before:  100,000K, after:  60,000K).
  439.         Don't  overdo  this,  of  course.   Just  type  your
  440.         catalog files as  if you were  typing a letter  to a
  441.         friend.  Keep the CAPS LOCK off, and avoid  entering
  442.         product names  in uppercase  and you will be  OK (or
  443.         is it "ok"?).
  444.  
  445.         Do not  use high  ASCII characters  in your  catalog
  446.         files (*.CAT).   Characters such as  ║  ▒  █ ╚ ½  å
  447.         will  not  be  compiled  properly.  Absolutely avoid
  448.         them!
  449.  
  450.  
  451.     OTHER NECESSARY FILES BEFORE COMPILING:
  452.  
  453.     Although your catalog files  (*.CAT) are the most  important
  454.     files  that  you  need  to  have prior to compilation, there
  455.     are additional files that you can and should create.
  456.  
  457.     The  first  mandatory  file  required  for  compilation is a
  458.     "wait file".  This file is an ASCII text file that  contains
  459.     a message for your customer while the run-time module  works
  460.     on a task.   This file can  be created with  an editor,  and
  461.     must be saved  with the filename  "WAIT.TXT".  If  this file
  462.     does not  exist when  you go  to compile  your catalog using
  463.     COMPILE.EXE the compilation process will abort.   "WAIT.TXT"
  464.     is  absolutely  mandatory.   With  The  Disk  Vendor package
  465.     that  you  have  received  a  sample  "WAIT.TXT" file can be
  466.     found  that  you  may  use  as  a guide.  The most important
  467.     things  that  you  must  remember  when  working  with   the
  468.     "WAIT.TXT" file is that it  can NOT be longer 72  characters
  469.     wide  by  17  rows  high.   Also,  this  wait  file must not
  470.     contain any high ASCII characters.
  471.  
  472.     The second (and last)  mandatory file that must  exist prior
  473.     to compilation  is a  shipping text  file.   Identified with
  474.     the filename "SHIPPING.TXT", this file contains  information
  475.     on  the  shipping/mailing  methods  that  you  provide  your
  476.     customers with,  and their  costs.   A sample "SHIPPING.TXT"
  477.     file has been included with The Disk Vendor system that  you
  478.     received and  can be  used as  a guide.   Its format  is  as
  479.     follows:
  480.  
  481.     [Type of shipping]=[Cost]
  482.  
  483.     Where  [Type of shipping]  is  replaced   with   the   words
  484.  
  485.     identifying the type  of shipping/mailing method  available,
  486.     and where  [Cost]  is replaced with  the actual cost.  These
  487.     two parameters are linked together with a "=" equals symbol.
  488.     Here is  a real  life example  of a  "SHIPPING.TXT" file, so
  489.     that you can see better the format you must follow:
  490.  
  491.     USPS (US)=2.95
  492.     USPS (Canada)=5.00
  493.     USPS (Elsewhere)=7.00
  494.     UPS Ground (US)=4.00
  495.     UPS Blue (48 Sts)=7.00
  496.     UPS Blue (AL HI PR)=8.00
  497.     UPS Red (US)=16.00
  498.     UPS Red (AL HI PR)=19.00
  499.     Federal Express overnight=20.00
  500.  
  501.     You can have  one line in  your shipping file,  or 10 lines.
  502.     You have the choice  to add or delete  any lines.  The  only
  503.     requirement  is  that  at  least  one  line  exists  in  the
  504.     "SHIPPING.TXT"  file,  and  that   you  follow  the   format
  505.     outlined above.
  506.  
  507.     Having your  catalog files  (*.CAT) and  the "WAIT.TXT"  and
  508.     "SHIPPING.TXT"  files,  you  can  now  begin the compilation
  509.     process  if  you  wish.   These  files  are mandatory before
  510.     running COMPILE.EXE.   You may wish  to add some  additional
  511.     files, but this is optional (see next section).
  512.  
  513.  
  514.     OPTIONAL TEXT FILES TO INCLUDE IN YOUR CATALOG:
  515.  
  516.     Many businesses and  companies who use  The Disk Vendor  may
  517.     wish to add additional ASCII text files for their  customers
  518.     to view.   This can  be done  with an  editor, and  the only
  519.     requirements that The Disk Vendor impose are:
  520.  
  521.     1) The text  file must NOT  contain  control  characters nor
  522.     high ASCII characters > 126 (decimal).
  523.  
  524.     2) The  text file  must be  saved with  a filename extension
  525.     ".TXT"  (short  for  "text").   "BONUS.TXT",   "README.TXT",
  526.     "COUPON.TXT", "SPECIALS.TXT" are all valid text filenames.
  527.  
  528.     3) The   text file   can be   any length  in number  of rows
  529.     (within reason), but  must not exceed  72 characters/columns
  530.     in width.
  531.  
  532.     4) The first line of your  .TXT file must be reserved for  a
  533.     description  line.   This  reserved  description  line works
  534.     exactly  as  the  description  line  in  your  catalog files
  535.     (*.CAT).   This  description  line  will  appear in the Main
  536.     Menu  catalog  index  box  and  must  contain  less  than 35
  537.  
  538.     characters.   Again, this  description line  MUST reside  on
  539.     line 1 of your text file!
  540.  
  541.     What would you use .TXT files for?  Some possibilities are:
  542.  
  543.         To describe your company and its products.
  544.  
  545.         To display a discount coupon that the customer can
  546.         print using the PRINT SCREEN key and then redeem.
  547.  
  548.         To explain your return policies.
  549.  
  550.  
  551.     GRAPHIC IMAGE LINKS:
  552.  
  553.     You  can  now  give  your  customers  a graphic view of your
  554.     products by converting a 640  x 480 16-color VGA image  to a
  555.     self-executable file.   You can  use the  shareware  product
  556.     Grabber, or  Graphics Workshop  to generate  your image .EXE
  557.     files, or you can use  a commercial product such as  Inset's
  558.     HiJaak Graphics Suite.
  559.  
  560.     After you have  generated an .EXE  of an image,  it would be
  561.     wise  to  compress  the  .EXE  with  PKLite  by PKWare, Inc.
  562.     PKLite will shrink  the size of  your .EXE image  by 50-80%,
  563.     resulting in an increase in available free disk space.
  564.  
  565.     Once you  have your  shrunk, executable  graphic image,  you
  566.     will need  to rename  the file.   There are  two things  you
  567.     must take  into consideration  when you  rename your graphic
  568.     .EXE images:  1) the  file extension  (which determines  HOW
  569.     the images  are displayed),  and 2)  the 1-8  character file
  570.     name (preceding the extension).
  571.  
  572.     The filename of your graphic  .EXE image must be renamed  to
  573.     match  the  corresponding  product  item CATALOG NUMBER that
  574.     you  want  the  image  to  be  linked  to.   You must have a
  575.     catalog  item/part  number  in  order  to  use graphic image
  576.     links!   For  example,  let's  say  that  you are an antique
  577.     dealer, and that  you have an  item in your  .CAT file which
  578.     is  identified  with  the   part  number  "ROME34A"   (which
  579.     identifies a 2000  year old Roman  silver coin).   You would
  580.     then  want  to   create  a  graphic   image  that  gives   a
  581.     representation  of  this  Roman  coin,  save the image to an
  582.     .EXE file using  the file name  ROME34A.EXE, then shrink  it
  583.     with PKLite (PKLite is an optional step).
  584.  
  585.     Next, the .EXE file  extension will be changed  according to
  586.     one of the following 3 rules:
  587.  
  588.     File extension: .4CE
  589.  
  590.     If you  rename ROME34A.EXE  to ROME34A.4CE  then this  image
  591.     file  will  be  displayed  AUTOMATICALLY  when your customer
  592.     arrives  at  the  text  screen  for  your ROME34A Roman coin
  593.     description.   Actually, the  image will  be displayed prior
  594.     to the text display, and not after.  The user has no  say-so
  595.     on whether  the image  is displayed  or not  - it  is FORCED
  596.     upon  them,  and  therefore  the  file  extension  is ".4CE"
  597.     (four-ce).
  598.  
  599.     File extension: .CHO
  600.  
  601.     There is   a time   and place   for forcing   an image  upon
  602.     your customers, but you   don't want to   get too bossy  and
  603.     force  all  of  your  images  all  the time.  An alternative
  604.     would be  to give  your customers  the CHOICE  as to whether
  605.     they wish to view the accompanying graphic image, but  still
  606.     in  a  not-so-subtle  manner.   If  this  "let your customer
  607.     choose" method  is the  way you  would like  to present   an
  608.     image  of  your antique Roman  coin, you then  should rename
  609.     your ROME34A.EXE  image file  to ROME34A.CHO.   The   ".CHO"
  610.     extension   will cause  a dialog  window    to AUTOMATICALLY
  611.     pop   up   when your  customer arrives  at the  ROME34A text
  612.     description screen.   The pop-up   dialog   will notify  the
  613.     customer that  an image  for this  product exists,  and will
  614.     ask if they  would like to  view the image  at that point  -
  615.     yes or  no.   The pop-up  dialog will  be "forced"  upon the
  616.     customer, but the customer still  has the last word and  can
  617.     decide not to view the graphic image.
  618.  
  619.     File extension: .OPT
  620.  
  621.     The last method  to display a  graphic image is  to let your
  622.     customers at their own discretion initiate the display.   By
  623.     renaming ROME34A.EXE to  ROME34A.OPT, the customer  can view
  624.     the  image  by  pressing  the  [V]  key when they are at the
  625.     product text description screen.  As a reminder, the  bottom
  626.     line  of  the  screen  will  reflect  the fact that an image
  627.     exists, should the  customer wish to  view it.   This method
  628.     of displaying  images is  called "OPTIONAL",  and hence  the
  629.     file extension of ".OPT".
  630.  
  631.  
  632.     WILDCARD IMAGES:
  633.  
  634.     If you would like to have JUST ONE executable graphic  image
  635.     linked to  several different  products in  your catalog, you
  636.     can  accomplish  this  with  "wildcard"  images.  Here is an
  637.     example of how this would work.  Let us continue to use  the
  638.  
  639.     antique dealer's catalog...but let  us say that his  catalog
  640.     contained  several   Roman  coins,   with  catalog   numbers
  641.     ROME34A, ROME102C, ROME-ALL, ROME9Q, and ROME_1BC.  In  each
  642.     of  these  catalog  numbers,  the  first  four  letters  are
  643.     identical,  i.e.  "ROME".   Let  us  say  that  this antique
  644.     dealer did  not want  an image  for each  coin individually,
  645.     but rather collectively.  In other words, the dealer  wanted
  646.     just   one   graphic   image,   where   several  coins  were
  647.     collectively shown in  the image, and  that one image  to be
  648.     made available for viewing from ANY of the "ROME"  pre-fixed
  649.     catalog items.   He could  accomplish this  by creating  one
  650.     graphic  .EXE  of  all  his  coins  and name the final image
  651.     ROME#.OPT or ROME#.CHO or ROME#.4CE.  The "#" symbol in  the
  652.     file  name  represents  a  wildcard,  meaning that a graphic
  653.     link  will  be  made  if  any  catalog  number  matches  the
  654.     characters preceding the "#" wildcard.  So "ROME#.4CE"  will
  655.     display each time a  catalog number with the  letters "ROME"
  656.     appear in it.
  657.  
  658.     Note: Whenever you use any self-executing graphic images you
  659.     must remember that  these images  are not  incorporated into
  660.     the compiled  CATALOG.DAT file.  Therefore YOU MUST REMEMBER
  661.     to physically place all  graphic files on the  disk that you
  662.     will be distributing to your customers.
  663.  
  664.  
  665.     HELLO AND GOODBYE:
  666.  
  667.     Should  you  wish  to  create  a special opening screen that
  668.     your customer  views before  the Main  Menu screen  appears,
  669.     then  create  a  "hello"  file.   This  file is also created
  670.     using  an  editor,  and  must  be  saved  with  the filename
  671.     "HELLO.TXT".    Unlike   other   ASCII   text   files,   the
  672.     "HELLO.TXT" file can contain high ASCII graphic  characters.
  673.     This  will  enable  you  to  create  some attractive opening
  674.     screens with boxes  and shadows and  text.  The  "HELLO.TXT"
  675.     file  can  contain  up  to  25  lines  of  characters  by 80
  676.     characters  in  width  (the  size  of  a  normal  text  mode
  677.     screen).  Here is an example of what you could do:
  678.  
  679.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  680.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  681.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  682.       ▓▓▓▓▓┌───────────────────────────────────────┐▓▓▓▓▓▓▓▓▓
  683.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  684.       ▓▓▓▓▓│    XYZ COMPUTERS PROUDLY PRESENTS     │░░▓▓▓▓▓▓▓
  685.       ▓▓▓▓▓│        ITS WINTER 1995 SOFTWARE       │░░▓▓▓▓▓▓▓
  686.       ▓▓▓▓▓│          CATALOG ON A DISK            │░░▓▓▓▓▓▓▓
  687.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  688.       ▓▓▓▓▓│       Press any key to begin...       │░░▓▓▓▓▓▓▓
  689.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  690.       ▓▓▓▓▓└───────────────────────────────────────┘░░▓▓▓▓▓▓▓
  691.       ▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓▓▓▓▓▓▓
  692.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  693.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  694.  
  695.     Just remember  to include  an instruction  for your customer
  696.     to "PRESS ANY KEY TO CONTINUE..." or else you may find  your
  697.     customer  scratching  his  head  wondering  what to do next.
  698.     You may  never receive  an order  from him  because he could
  699.     not get past your opening screen!
  700.  
  701.     Likewise, if you  wish to have  a special message  appear at
  702.     the close of  the program, create  a "goodbye" file  with an
  703.     editor.   Follow exactly  the same  guidelines as  described
  704.     above  for  the  "hello"  file,   but  save  this  file   as
  705.     "GOODBYE.TXT".   Again,  remind the customer with  a message
  706.     to press any key to exit the program!
  707.  
  708.     Both the "HELLO.TXT"  and "GOODBYE.TXT" files  are optional.
  709.     You may wish not to have opening or closing screens, or  you
  710.     may wish  to have  one but  not the  other.   This is  fine.
  711.     Just delete the files you  don't need, or don't create  them
  712.     in the first place.
  713.  
  714.     For  those  who  wish  to  use a high-resolution VGA graphic
  715.     image  in  the  place  of  the  text  based  HELLO.TXT   and
  716.     GOODBYE.TXT files, generate a self-executable  640 x 480 VGA
  717.     image and use the file names  HELLO.EXE or  GOODBYE.EXE  and
  718.     place these files on the disk that you will be distributing.
  719.  
  720.  
  721.     THAT'S ALL FOLKS!:
  722.  
  723.     Speaking of "goodbyes", the  instructions above are all  you
  724.     need to get  you up and  running creating your  own personal
  725.     shareware catalog on disk.   We hope that you find  The Disk
  726.     Vendor a useful tool in marketing your products.
  727.  
  728.     Although we feel confident that  you will not find a  better
  729.     and  more flexible product  for marketing  your merchandise,
  730.     there are two groups of distributors  that would do well NOT
  731.     to  use The Disk Vendor.  To  get specific, The  Disk Vendor
  732.     must  not  be used  by  vendors  who   distribute  so-called
  733.     "Adult"  (R/X-rated) products.  We  will not  be  a party in
  734.     helping vendors  distribute such  material.  Distributors of
  735.     tobacco products are likewise prohibited from using The Disk
  736.     Vendor.  Violators  caught  using  The  Disk ⁿVendor  in the
  737.     distribution  of the above mentioned products may face legal
  738.     action.
  739.  
  740.  
  741.     SHAREWARE:
  742.  
  743.     The Disk Vendor is  shareware software and continued  use of
  744.     the program requires  you to support  the author.   Once you
  745.     have registered, you will receive the latest version of  The
  746.     Disk Vendor that will permit you to begin distributing  your
  747.     compiled  data  file  (CATALOG.DAT)  and the run-time module
  748.     (CATALOG.EXE) freely without royalties.
  749.  
  750.  
  751.     ALL IN THE FAMILY:
  752.  
  753.     Attention shareware distributors!!!!   If you would like  to
  754.     use  The  Disk  Vendor  to  distribute  public  domain   and
  755.     shareware software disks, we  have a special version  of The
  756.     Disk Vendor JUST  FOR YOU!   Custom tuned for  the shareware
  757.     industry,  The  Disk  Vendor  "shareware vendor" version has
  758.     features  unique  to  your  industry,  such  as   multi-disk
  759.     prices,  separate  pricing  structures  for 360K, 720K, 1.2M
  760.     and 1.4M disk  sizes.  We  highly recommend this  "shareware
  761.     vendor" version  if you  need a  catalog on  disk system  to
  762.     distribute  your  shareware  library.   Contact  the program
  763.     author  with a SASE  or by phone to  learn more details.  Or
  764.     better yet, download a demo copy from our BBS: 703 372-9680.
  765.     The shareware file is named VEND??SW.ZIP where ?? represents
  766.     the current program version, or leave a message to SYSOP.
  767.  
  768.     CAN I CONVINCE YOU TO CONVERT?:
  769.  
  770.     Question:  "I  currently  use  EmmaSoft's  Catalog-On-A-Disk
  771.     program to distribute  the  products we sell and would  like
  772.     to switch  to The  Disk Vendor.   What are  the  differences
  773.     between these two products, and can I salvage my COAD  *.TXT
  774.     files for use with The Disk Vendor?"
  775.  
  776.     Answer:
  777.  
  778.     1)  A  very  clean,  uncluttered,  attractive user interface
  779.     distinguishes   our   product   from   EmmaSoft's   product.
  780.     Your customers will find   it easier to  use,  and hopefully
  781.     order more products from you   if they can navigate   easily
  782.     through the on-disk catalog that you have provided them.
  783.  
  784.     2)  On  your  distribution  disk  to your customer, only two
  785.     files need to  exist for your  on-disk catalog to  run using
  786.     The  Disk  Vendor  -  (CATALOG.EXE  and  CATALOG.DAT).   Our
  787.     competitor creates dozens of ".CM" files if you have  dozens
  788.     of  product  categories.   So  what,  you  may  ask?  Again,
  789.     getting back  to the  story of  available disk  space.   The
  790.     more available  space on  your distribution  disk, the  more
  791.     products  or   better  descriptions   you  can   offer  your
  792.     customers.  It is a hardware fact in DOS that if you have  a
  793.     file  on  a  360K  disk  that  is  only  11  bytes  long, it
  794.     actually will  take up  1024 bytes  of disk  space!  This is
  795.     due  to  the  way  files  are  allocated  on  a  disk.   For
  796.     instance,  if  you  have  a  file  called  "HELLO.CM" and in
  797.     it contains  the letters  "HELLO WORLD",  although the  file
  798.     listed in  a DIR  command shows  the file  size as  11 bytes
  799.     long, it actually  displaces 1024 bytes  on disk.   Multiply
  800.     "HELLO.CM" two dozen times, and 264 bytes (24 x 11) now  has
  801.     displaced 24576 bytes!  Alright,  so what's the point?   The
  802.     point is that the more  files you have on your  distribution
  803.     disk, the more  disk space you  are most likely  wasting due
  804.     to partially  filled clusters.   The Disk  Vendor eliminates
  805.     wasted disk  space by  needing only  two files  to exist  on
  806.     your  distribution  disk  -  CATALOG.EXE  and   CATALOG.DAT.
  807.     Also,  needing  only  two  files  on  your distribution disk
  808.     makes file housekeeping chores much easier.
  809.  
  810.     3) The  compilation of  your catalog  ASCII text  files to a
  811.     single catalog  data file  (CATALOG.DAT) is  a one-step wham
  812.     bam, "run it once and  I'm done process".  Our  competitor's
  813.     product requires you  to compile two  dozen ".CM" files  one
  814.     at a  time if  you have  two dozen  product categories.  The
  815.     Disk  Vendor  saves  you  time,  compiling  ALL your catalog
  816.     ASCII files  automatically in  one swoop,  insuring that the
  817.     resulting  CATALOG.DAT  file  is  the  latest  and  contains
  818.     complete, up to date information.
  819.  
  820.     4) The  Disk Vendor  provides you  with a  utility that will
  821.     convert all  your Catalog-On-A-Disk  .TXT files  to The Disk
  822.     Vendor ASCII .CAT format.  Converting from our  competitor's
  823.     product to  The Disk  Vendor couldn't  be easier!   You lose
  824.     none of  your hard  work.   Copy the  file "COAD_CVT.EXE" to
  825.     the directory where you store your EmmaSoft COAD .TXT files,
  826.     then  run "COAD_CVT.EXE" from DOS.  This conversion  utility
  827.     will create new  catalog files (*.CAT)  that can be   placed
  828.     in  the  directory  where  The  Disk  Vendor  resides.
  829.  
  830.  
  831.